WriteAxisAlias

将别名索引写入轴。别名索引可让布缆在无法与程式吻合时，重新排列轴的清单。

语法

KsError WriteAxisAlias(
     int Index,
     int Alias
);

参数

Index：轴的索引。索引以 0 为起始；别名将影响此参数。

Alias：欲取代轴索引所使用的别名索引。索引以 0 为起始。

回传值

若此函式执行成功，会回传 errNoError，否则会传回错误码。如需更多有关错误码的资讯，请参阅 KsError 清单。

备注

• 重新排列轴。在 KINGSTAR 子系统启用后使用。
• 别名索引可在轴的实际索引范围之外。

可用的 EtherCAT 状态

ecatOP

范例

#define AxisX 101
#define AxisZ 102
#define AxisC 103

// Apply the aliases
nRet = WriteAxisAlias(1, AxisX);
nRet = WriteAxisAlias(2, AxisZ);
nRet = WriteAxisAlias(0, AxisC);
nRet = EnableAliases(TRUE);

使用需求

参见

EnableAliases

GetAliasesStatus

ReadAxisAlias